$TXT Created by MURDOCK,.DNS      URL          (KIDS) on Friday, 06/28/19 at 08:44 =============================================================================
Run Date: JUL 08, 2019                     Designation: IVM*2*183
Package : IVM - INCOME VERIFICATION MATCH     Priority: Mandatory
Version : 2                                     Status: Under Development
=============================================================================

Associated patches: (v)IVM*2*115   <<= must be installed BEFORE `IVM*2*183'
                    (v)IVM*2*149   <<= must be installed BEFORE `IVM*2*183'

Subject: ACCEPT MT COPAY EXEMPT AND GMT COPAY REQUIRED TO SUPPORT VFA

Category: 
  - Routine
  - Enhancement (Mandatory)

Description:
============

 Patch IVM*2.0*183 is being released to support the enhancements for the  Enterprise Health Benefits Determination (EHBD) program that focuses on  updates for the Enrollment System Modernization (ESM) Phase 2 project.
  
 Patch IVM*2.0*183 is also being released in support of the Enrollment  System (ES) 5.7 release. Refer to Informational Patch EAS*1*TBD  (Enrollment Application System) for additional detail regarding the ES  release.
  
 When a site receives an income test update from the Health Eligibility  Center (HEC) (Health Level 7 (HL7) ORU/ORF-Z10 message type), a number of  checks are completed on the incoming data before allowing that  information to update the site's database. One of the checks is to  determine whether the test is a current income test. If an incoming test  date is more than 365 days old, the system rejects and does not upload  the test if the status is Means Test (MT) Copay Exempt (MT COPAY EXEMPT)  or Geographic Means Test (GMT) Copay Required (GMT COPAY REQUIRED).
  
 IVM*2.0*183 modifies how Veterans Health Information System and  Technology Architecture (VistA) determines if an income test is the active  current test per Veteran's Financial Assessment (VFA) rules. Subject to  existing criteria, it will also consider the following as current income  tests and upload the MT: The received income test has an MT Date greater  than or equal to one year prior to the VFA Start Date (VFA Start Date =  1/1/2013), and the MT status is either MT COPAY EXEMPT or GMT COPAY  REQUIRED. Note: Rules that determine whether the site has a more current  income test and whether the test is active or inactive have not been  modified, and may result in rejection of the income test. For example, if  there is a 2017 income test on file at the site, and a 2015 income test is  received from ES, the incoming test is not a current test, so it will be  rejected and will not upload. 
  
 VistA users can view the accepted MT in the View a Past Means Test [DG  MEANS TEST VIEW TEST] option. Because the test has been accepted, the  user will not see messages such as "MEANS TEST REQUIRED" in these  scenarios.
  
 An MT will be accepted from the ES when an HL7 ORU/ORF-Z10 message  is received at correlated sites using VFA rules to determine if the MT is  a current active test. The following criteria are added to that
 determination:
  
      a. The MT Date is greater than or equal to one year prior to the VFA
         Start Date, the patient is subject to Means Testing, and the 
         patient's MT status is MT COPAY EXEMPT.
  
         OR
  
      b. The MT Date is greater than or equal to one year prior to the VFA
         Start Date, the patient is subject to Means Testing, the 
         patient's MT status is GMT COPAY REQUIRED, and the patient has
         agreed to pay the deductible(s).
   
 When ES sends an HL7 ORU/ORF-Z10 message containing the ZMT segment to  VistA sites where the Veteran is known, the system will accept and  process the income test when the above conditions exist. Previously  rejected Z10 messages can also be resent and processed per the above  criteria.
    
   
 Patch Components:
 -----------------
   
   
 Files & Fields Associated:
   
 File Name (Number)         Field Name (Number)     New/Modified/Deleted
 ------------------         -------------------     --------------------
 N/A
   
   
 Forms Associated:
   
 Form Name     File #     New/Modified/Deleted
 ---------     ------     --------------------
 N/A
   
   
 Mail Groups Associated:
   
 Mail Group Name     New/Modified/Deleted
 ---------------     --------------------
 N/A
   
   
 Options Associated:
   
 Option Name              Type                 New/Modified/Deleted
 -----------              ----                 -------------------- 
 N/A
   
   
 Protocols Associated:
   
 Protocol Name     New/Modified/Deleted
 -------------      -------------------- 
 N/A
   
   
 Security Keys Associated:
   
 Security Key Name
 -----------------
 N/A
   
   
 Templates Associated:
   
 Template Name     Type     File Name (Number)  New/Modified/Deleted
 -------------     ----     ------------------  --------------------
 N/A
   
   
 Remote Procedures Associated:
   
 Remote Procedure Name       New/Modified/Deleted
 ---------------------       --------------------
 N/A
   
   
 Parameter Definitions Associated: 
   
 Parameter Name              New/Modified/Deleted
 --------------              --------------------
 N/A
   
   
 Additional Information:
 -----------------------
   
 New Service Requests (NSRs):
 N/A
   
   
 Patient Safety Issues (PSIs):
 N/A
   
   
 Defect Tracking System Ticket(s) & Overview:
 N/A
   
 Problem:
 --------
 N/A
   
 Resolution:
 -----------
 N/A 
   
 Test Sites:
 -----------                                      
 TBD
   
 Software and Documentation Retrieval Instructions:
 ---------------------------------------------------- 
 This software is being released as a patch (PackMan) message.
 Documentation describing the new functionality is included in this 
 release. 
  
 The preferred method is to retrieve the files from 
 download.DNS.URL. This transmits the files from the first 
 available server. Sites may also elect to retrieve the files 
 directly from a specific server.
   
 Sites may retrieve the software and/or documentation directly using 
 Secure File Transfer Protocol (SFTP) from the ANONYMOUS.SOFTWARE 
 directory at the following OI Field Offices:
   
 Hines:          DNS     .URL         
 Salt Lake City: DNS.URL       
   
 Documentation can also be found on the VA Software Documentation Library
 at: https://DNS.URL/
   
 Documentation Title             File Name                      SFTP Mode
 --------------------------------------------------------------------------
 IVM*2.0*183 Release Notes       IVM_2_183_RN.PDF              binary
   
   
 Host File Name                           FTP Mode
 ---------------------------------------------------------------------
 N/A
   
   
 Patch Installation:
 -------------------
   
   
 Pre/Post Installation Overview:
   
   
 Pre-Installation Instructions:
  -----------------------------
 1. This patch should NOT be installed while the IVM BACKGROUND JOB 
    [IVM BACKGROUND JOB] is running.
   
 2. The HL7 incoming/outgoing filers should be stopped. Stop All 
    Messaging Background Processes by using the [HL STOP ALL] option on
    the Filer and Link Management Options [HL MENU FILER LINK MGT] 
    menu on the HL7 Main Menu [HL MAIN MENU].
   
 3. This patch may be installed with users on the system; although
    it is recommended that it be installed during non-peak hours to
    minimize potential disruption to users.  This patch should take less
    than 5 minutes to install.
   
   
 Installation Instructions:
   
 1. Choose the PackMan message containing this build. Then select the   
    INSTALL/CHECK MESSAGE PackMan option to load the build.
   
 2. From the Kernel Installation and Distribution System Menu, select the
    Installation Menu.  From this menu, 
   
    A. Select the Verify Checksums in Transport Global option to 
       confirm the integrity of the routines that are in the transport  
       global. When prompted for the INSTALL NAME enter the patch or build
       name IVM*2.0*183.
   
       NOTE: Using <spacebar><enter> will not bring up a Multi-Package 
             build even if it was loaded immediately before this step. It
             will only bring up the last patch in the build.
   
    B. Select the Backup a Transport Global option to create a backup 
       message of any routines exported with this patch. It will not backup
       any other changes such as DDs or templates.
   
    C. You may also elect to use the following options: 
       i. Print Transport Global - This option will allow you to view the
          components of the KIDS build.
       ii. Compare Transport Global to Current System - This option will
           allow you to view all changes that will be made when this 
           patch is installed.  It compares all of the components of this
           patch, such as routines, DDs, templates, etc.
   
    D. Select the Install Package(s) option and choose the patch to 
       install. 
    
       i. If prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of
           Install? NO//', answer NO.
        
       ii. When prompted 'Want KIDS to INHIBIT LOGONs during the install? 
           NO//', answer NO.
        
       iii. When prompted 'Want to DISABLE Scheduled Options, Menu Options,
            and Protocols? NO//', answer NO.
   
         a. When prompted 'Enter protocols you wish to mark as 
            'Out Of Order':', press the Enter key.
   
         b. If prompted 'Delay Install (Minutes):  (0 - 60): 0//', respond
            0.
   
   
 Post-Installation Instructions:
 The HL7 incoming filers should be restarted. Use the Restart/Start All 
 Links and Filers [HL TASK RESTART] option on the Filer and Link 
 Management Options [HL MENU FILER LINK MGT] menu on the HL7 Main Menu 
 [HL MAIN MENU].
   
   
 Back-Out/Roll Back Plan:
  ------------------------
 In the event a site determines that this patch should be backed out, the 
 site should submit a YOUR IT Services ticket with the Enterprise Service 
 Desk (ESD) for assistance with the procedure.
   
 Any issues would need to be evaluated to determine if: a back-out of the 
 software is appropriate; a new patch is needed; or if data requires 
 correction or restoration.
    
 During installation, if the option to back up routines was run as 
 directed, "Backup a Transport Global", then routines will have the 
 ability to be restored from the "backup" MailMan message that was 
 generated. However, the KIDS installation process does not perform a 
 backup of other VistA software components, such as DD, cross-reference, 
 and template changes.

Routine Information:
====================
The second line of each of these routines now looks like:
 ;;2.0;INCOME VERIFICATION MATCH;**[Patch List]**;21-OCT-94;Build 11

The checksums below are new checksums, and
 can be checked with CHECK1^XTSUMBLD.

Routine Name: IVMCM
    Before: B80339401   After: B82136902  **12,17,28,41,44,53,34,49,59,
                                           55,63,77,74,123,115,183**
Routine Name: IVMUFNC5
    Before:  B8601879   After: B16993750  **55,109,149,183**
 
Routine list of preceding patches: 115, 149

=============================================================================
User Information:
Entered By  : MURDOCK,HAYES                 Date Entered  : MAY 08, 2019
Completed By:                               Date Completed: 
Released By :                               Date Released : 
=============================================================================


Packman Mail Message:
=====================
